---
title: TextField
description: A text input that allow users to input custom text entries with a keyboard.
component: true
kobalte:
    link: https://kobalte.dev/docs/core/components/text-field
    api: https://kobalte.dev/docs/core/components/text-field#api-reference
---

<ComponentPreview name="textfield-demo" />

## Installation

<Tabs defaultValue="cli">

<TabsList>
    <TabsTrigger value="cli">CLI</TabsTrigger>
    <TabsTrigger value="manual">Manual</TabsTrigger>
    <TabsIndicator class="bg-primary" />
</TabsList>

<TabsContent value="cli">

```bash
npx shadcn-solid@latest add textfield
```

</TabsContent>

<TabsContent value="manual">

<Steps>

<Step>Install the following dependencies:</Step>

```bash
npm install @kobalte/core
```

<Step>Copy and paste the following code into your project.</Step>

<ComponentSource name="textfield" />

<Step>Update the import paths to match your project setup.</Step>

</Steps>

</TabsContent>

</Tabs>

## Usage

```tsx
import { TextField, TextFieldInput } from "@/components/ui/textfield"
```

```tsx
<TextField>
    <TextFieldInput type="email" placeholder="Email" />
</TextField>
```

## Examples

### Disabled

<ComponentPreview name="textfield-disabled" />

---

### With Label

<ComponentPreview name="textfield-with-label" />

---

### With Text

<ComponentPreview name="textfield-with-text" />

---

### With Button

<ComponentPreview name="textfield-with-button" />

---

### File

<ComponentPreview name="textfield-file" />
